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Abstract. The SuperAGILE (SA) instrument is a X-ray detector for As- 
trophysics measurements, part of the Italian AGILE satellite for X-Ray and 
Gamma- Ray Astronomy launched at 23/04/2007 from India. SuperAGILE is 
now studying the sky in the 18 - 60 KeV energy band. It is detecting sources 
with advanced imaging and timing detection capabilities and good spectral de- 
tection capabilities. Several astrophysical sources has been detected and local- 
ized, including Crab, Vela and GX 301-2. The instrument has the skill to resolve 
correctly sources in a field of view of [-40, +40] degrees interval, with the an- 
gular resolution of 6 arcmin, and a spectral analysis with the resolution of 8 
keV. Transient events are regularly detected by SA with the aid of its temporal 
resolution (2 microseconds) and using signal coincidence on different portions of 
the instrument, with confirmation from other observatories. The SA data pro- 
cessing scientic software performing at the AGILE Ground Segment is divided 
in modules, grouped in a processing pipeline named SASOA. The processing 
steps can be summarized in data reduction, photonlist building, sources extrac- 
tion and sources analysis. The software services allow orbital data processing 
(near real-time), daily data set integration, Temporal Data Set (TDS) process- 
ing and TDS processing with source target optimization (TDS_SRC). Automatic 
data processing monitoring and interactive data analysis is possible from an in- 
ternet connected workstation, with the use of SA data processing Web services. 
Many solutions were implemented in order to achieve fault tolerance. Archive 
management and data storage are performed with the help of relational database 
instruments. 



1. The SuperAGILE processing pipeline 

The SASOA (Super Agile Standard Orbital Analysis) pipeline is composed by a 
succession of elaboration tasks applied on the SA detected eventlist, the output 
of a certain task is the input of the following. Macro-tasks launch other subfunc- 
tions, some of them are implemented by external scripts and batch programs. 
In SASOA, a daemon running an endless loop provides to check if data for the 
incoming contacts are available and when they are found, the trigger for con- 
tact data processing is given. Data for a given contact mostly contain the data 
related to measurements acquired by the AGILE instruments during the last or- 
bit. The failure of a single task of the pipeline may block the production of the 
final output data for a single run but the failure of a single contact run does not 
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Table 1. SASOA software Data Processing Stages 



n. 


STAGE 


Description 


1 


TRIGGER 


control if new data arc transmitted 


2 


DATA.DOWNLOAD 


if triggered download available data 


3 


COMMANDS_PARSING 


parse run options 


4 


LOCAL_SETTINGS 


set hosts and data coordinates 


5 


DATA.FETCH 


load data input for actual run in local buffer 


6 


FILE_NAMING 


creates file names following the standard 


7 


CORRECTION 


perform data correction task 


8 


ORBIT.REBUILDING 


rebuild data related on a given orbit 


8 


DATA.REDUCTION 


data separation, reconstruction and equalization 


9 


PHOTONLIST_BUILDING 


analyse data of the reduced photon list 


10 


ATTITUDE.CORRECTION 


correction for the attitude wobbling 


11 


IMAGING 


image extraction 


12 


FILING 


archive produced data 



stop the daemon for the next incoming triggers and related data processing run. 
Different kinds of triggers can be used: the first way used to trigger the sasoa 
pipeline is to control if a file with extension .ok is generated by the preprocessing 
system for the incoming contact data, i. e. if a file named "VC1. 002469. 009. ok" 
is present, data for the contact 2469 are correctly generated and available on the 
data area of the preprocessing machine. Another trigger modality is to control 
if a value in a database of the ASDC Data Center is changed. When the system 
has assured that data are present, then the data are downloaded from the gtb 
server in Bologna using the wget utility (see M. Trifoglio et Al, Archiving the 
AGILE Level- 1 telemetry data, Astronomy and Astrophysics, 2008, ), data from 
ASDC are downloaded with wget also, but they have to be downloaded one by 
one (mirror and -A option are disabled) to avoid transmission band overloading. 
Data products (histograms, plots, statistics & reports) are generated at different 
levels, hosts coordinates, data directories paths and other configurations of the 
processing system are set. The most important input telemetry data used for 
SA instrument data analysis are eventlist data (SA TM 3905), attitude data 
(SA TM 3914), and ephemerides data (SA TM 3916). The file names for i/o 
file of all tasks are generated following the official naming convention, the cor- 
rection stage performs time synchronization among input data files and other 
corrections. Then some actions useful to rebuild the orbital organization of the 
data are performed: if the contact contains more than 1 orbit, then data are 
divided in the respective parts and the pipeline is launched on the first part of 
data. After the run end, the system is triggered on the 2nd part. In the Data 
Reduction stage the eventlist from the previous stage is taken as input (complete 
orbit or orbital part), with efficiency files and then a reduced output eventlist 
is generated. In the Sources Extraction stage, the data are corrected removing 
wobbling effects, then the exposure is evaluated using informations regarding 
Earth Occultation and SAGA time periods. After these steps the imaging pro- 
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Figure 1. TDS processing schema 




Figure 2. TDS SRC software GUI 



cedure is applied and sources lists are generated, giving position and flux for the 
detected sources. 



2. Temporal Data Set processing 

Telemetry data are preprocessed and archived with the aid of the tmpps system 
furnished by the GTB Team (see M. Trifoglio et Al, Astronomy and Astro- 
physics, 2008). Data of SuperAGILE measurements have to be integrated over 
days and weeks to extract science information. The software utility performing 
this task is named TDS processing (TDS). The working schema of TDS is shown 
in fig. [TJ A web graphical user interface (GUI) is provided to launch data analy- 
sis applications through the web, the scientific user can perform its own analysis 
from elsewhere and using the preferred operating system (fig. [5]). TDS process- 
ing can be refined with specific source analysis operations, optimizing the results 
calculating the exposure of the celestial source in the given position, that is an 
input to the computation, expressed with (ra, dec) coordinates. This has also 
allowed long integration analysis on 3C 273 (see L. Pacciani et al, Astronomy 
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Figure 3. SA software monitor 

and Astrophysics, 2008) and on Markarian 421 (see I. Donnarumma et Al, The 
June 2008 flare of Markarian 421 from optical to TeV energies, ApJ, 2008). A 
web based monitor is showing the status of the automatic processing software 
in Figure [3] . 

3. Conclusions 

The SA scientific processing system is ready, enabling the access from web solve 
installation & portability problems. Processing stations will be added to fit with 
the actual number of data analysis software users. All SA software is portable, 
we have in use running versions of the whole processing system under Linux 
OpenSUSE (until 10.3 version, for 32 & 64bit architecture). 
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Figure 1. TDS processing schema 




Figure 2. TDS SRC software GUI 
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Figure 3. SA software monitor 
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